home *** CD-ROM | disk | FTP | other *** search
Text File | 2002-10-03 | 86.9 KB | 1,321 lines
XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) NNNNAAAAMMMMEEEE XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx - The SpinBox widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/SpinB.h> DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN SpinBox allows the user to select a value from a ring of related but mutually exclusive choices which are displayed in sequence. The SpinBox always has an increment arrow, a decrement arrow, and one or more other children. The choices are displayed, one at a time, in a traversable text child ( XXXXmmmmTTTTeeeexxxxtttt or XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd. The user clicks <<<<BBBBttttnnnn1111>>>> on an arrow to display the next (or previous) item in the ring of choices. By pressing and holding <<<<BBBBttttnnnn1111>>>> on an arrow, the user continuously cycles through the choices. The traversable children in a SpinBox can be of type XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC or XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG, as defined by the XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeeeconstraint resource. The ring of choices for numeric children is defined by minimum, maximum, incremental, and decimal point values. The ring of choices for string children is defined in an array of compound strings. The application programmer can include multiple traversable children in the SpinBox. For example, a SpinBox might consist of a pair of arrows and month, day, and year text fields. The arrows only spin the child that currently has focus. Arrow size is specified by the SpinBox resource XXXXmmmmNNNNaaaarrrrrrrroooowwwwSSSSiiiizzzzeeee. This value sets both width and height of each arrow in pixels. The programmer can display SpinBox arrows in one of several layouts, as specified by the XXXXmmmmNNNNaaaarrrrrrrroooowwwwLLLLaaaayyyyoooouuuuttttresource: XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG Places a pair of left and right arrows before the children. XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____EEEENNNNDDDD Places a pair of left and right arrows after the children. XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____SSSSPPPPLLLLIIIITTTT Places one arrow on each side of the children. XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____FFFFLLLLAAAATTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG Places a pair of arrows side by side before the _X_m_S_p_i_n_B_o_xchildren. Page 1 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____FFFFLLLLAAAATTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG Places a pair of arrows side by side after the _X_m_S_p_i_n_B_o_xchildren. Positions for XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGGand XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____EEEENNNNDDDD are dependent on the VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll resource XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn. When layout direction is left-to-right, beginning arrows are positioned to the left of the children. When layout direction is right-to-left, beginning arrows are positioned to the right. The actions of the arrows are determined by the VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll resource XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn. For left-to-right layouts, the right arrow is the increment arrow and the left arrow is the decrement arrow. For right-to-left layouts, the right arrow is the decrement arrow and the left arrow is the increment arrow. For a numeric type child, the increment arrow increases the displayed value by the incremental value up to the maximum. The decrement arrow decreases the displayed value by the given incremental value down to the minimum. The increment arrow for a string type child moves toward the last entry of the array of compound strings (by increasing the SpinBox constraint resource XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn). The decrement arrow moves toward the first entry of the compound string array. The programmer can also control the sensitivity of each arrow in the SpinBox. Sensitive arrows spin choices; insensitive arrows do not spin choices. Arrow sensitivity is set for the SpinBox widget by using the XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAArrrrrrrroooowwwwSSSSeeeennnnssssiiiittttiiiivvvviiiittttyyyy resource, but it can be modified on a per child basis by using the XXXXmmmmNNNNaaaarrrrrrrroooowwwwSSSSeeeennnnssssiiiittttiiiivvvviiiittttyyyy constraint resource. SpinBox provides two callbacks to application programmers. (In addition, the callbacks of the SpinBox's children may be invoked.) Each of these callbacks receives a pointer to XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk procedures are called _b_e_f_o_r_e a new choice is displayed. The XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk procedures are called _a_f_t_e_r a new choice is displayed. XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk tells the application what the new position will be in the ring of choices. This callback can be used to make the SpinBox stop at the upper and lower limits or go to a different, nonconsecutive choice. The application allows the change in position by leaving the _d_o_i_t member set to True. The application can spin to a position other than the next consecutive position by leaving Page 2 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) _d_o_i_t set to True and by changing the _p_o_s_i_t_i_o_n member to the desired position. When _d_o_i_t is set to False by an application, there is no change in the choice displayed. After a new choice is displayed, the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk procedure is called. The application can use this procedure to perform tasks when specific values are reached or when boundaries are crossed. For example, if the user spins from January back to December, the application could change to the previous year. If the user spins from December to January, the application could change to the next year. SpinBox dimensions can be set using the Core resources XXXXmmmmNNNNhhhheeeeiiiigggghhhhtttt and XXXXmmmmNNNNwwwwiiiiddddtttthhhh. If dimensions are not specified, the SpinBox size is determined by the sizes of its arrows and children. The SpinBox will attempt to grow so that the arrows and all children are visible. SpinBox uses the _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_ltrait and holds the _X_m_Q_T_n_a_v_i_g_a_t_o_r trait. CCCCllllaaaasssssssseeeessss SpinBox inherits behavior, resources, and traits from the CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr classes. The class pointer is _x_m_S_p_i_n_B_o_x_W_i_d_g_e_t_C_l_a_s_s. The class name is XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCCprefix and use the remaining letters. To specify one of the defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate whether the given resource can be set at creation time (C), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is not applicable (N/A). XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNarrowLayout XmCArrowLayout unsigned char XmARROWS_BEGINNING CSG XmNarrowOrientation XmCArrowOrientation unsigned char XmARROWS_VERTICAL CSG XmNarrowSize XmCArrowSize Dimension 16 CSG XmNdefaultArrowSensitivity XmCDefaultArrowSensitivity unsigned char XmARROWS_SENSITIVE CSG Page 3 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) XmNdetailShadowThickness XmCDetailShadowThickness Dimension 2 CSG XmNinitialDelay XmCInitialDelay unsigned int 250 ms CSG XmNmarginHeight XmCMarginHeight Dimension dynamic CSG XmNmarginWidth XmCMarginWidth Dimension dynamic CSG XmNmodifyVerifyCallback XmCCallback XtCallbackList NULL C XmNrepeatDelay XmCRepeatDelay unsigned int 200 ms CSG XmNspacing XmCSpacing Dimension dynamic CSG XmNvalueChangedCallback XmCCallback XtCallbackList NULL C XXXXmmmmNNNNaaaarrrrrrrroooowwwwLLLLaaaayyyyoooouuuutttt Specifies placement of the two arrows in the widget. Possible layouts are as follows: XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG Places left and right arrows beside each other, before the child(ren). Positioning for this layout is dependent on the VendorShell resource XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.... XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____EEEENNNNDDDD Places left and right arrows beside each other, after the child(ren). Positioning for this layout is dependent on the VendorShell resource XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn. XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____FFFFLLLLAAAATTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG Places a pair of arrows side by side before the _X_m_S_p_i_n_B_o_xchildren. Positioning for this layout is dependent on the VendorShell resource XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.... XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____FFFFLLLLAAAATTTT____EEEENNNNDDDD Places a pair of arrows side by side after the _X_m_S_p_i_n_B_o_xchildren. Positioning for this layout is dependent on the VendorShell resource XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn.... XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____SSSSPPPPLLLLIIIITTTT Places a left arrow on the left side and a right arrow on the right side of the child(ren). XXXXmmmmNNNNaaaarrrrrrrroooowwwwSSSSiiiizzzzeeee Specifies both the width and height of the arrow in pixels. XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAArrrrrrrroooowwwwSSSSeeeennnnssssiiiittttiiiivvvviiiittttyyyy Specifies the default sensitivity of the arrows in the widget. Insensitive arrows change color, Page 4 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) cannot be depressed, and perform no action. (This resource may be overridden by the constraint resource XXXXmmmmNNNNaaaarrrrrrrroooowwwwSSSSeeeennnnssssiiiittttiiiivvvviiiittttyyyy for individual traversable text children of the SpinBox.) Possible default sensitivity values are as follows: XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____SSSSEEEENNNNSSSSIIIITTTTIIIIVVVVEEEE Both arrows are sensitive. XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____DDDDEEEECCCCRRRREEEEMMMMEEEENNNNTTTT____SSSSEEEENNNNSSSSIIIITTTTIIIIVVVVEEEE Only the decrement arrow (as determined by XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn) is sensitive. The increment arrow is insensitive. XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____IIIINNNNCCCCRRRREEEEMMMMEEEENNNNTTTT____SSSSEEEENNNNSSSSIIIITTTTIIIIVVVVEEEE Only the increment arrow (as determined by XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn) is sensitive. The decrement arrow is insensitive. XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____IIIINNNNSSSSEEEENNNNSSSSIIIITTTTIIIIVVVVEEEE Both arrows are insensitive. XXXXmmmmNNNNddddeeeettttaaaaiiiillllSSSShhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss Specifies the thickness of the inside arrow shadows. The default thickness is 2 pixels. XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy Specifies how long, in milliseconds, the mouse button must be held down before automatic spinning begins. In other words, when the user selects the increment or decrement arrow and keeps it depressed, this delay occurs before the choices start spinning. If XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy is 0, then XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyyis used as the initial delay. XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt Specifies the amount of blank space between the top edge of the SpinBox widget and the first item in each column, and the bottom edge of the SpinBox widget and the last item in each column. XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh Specifies the amount of blank space between the left edge of the SpinBox widget and the first item in each row, and the right edge of the SpinBox widget and the last item in each row. XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk This callback is called before the SpinBox position changes (see the Constraint resource XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn). The application can use this Page 5 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) callback to set the next position, change SpinBox resources, or cancel the impending action. For example, this callback can be used to stop the spinning just before wrapping at the upper and lower position boundaries. If the _d_o_i_t member is set to False, nothing happens. Otherwise the position changes. Reasons sent by the callback are XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____NNNNEEEEXXXXTTTT, XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____PPPPRRRRIIIIOOOORRRR, XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____FFFFIIIIRRRRSSSSTTTT, or XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____LLLLAAAASSSSTTTT. XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy When the user selects and keeps an arrow button depressed by pressing and holding <<<<BBBBttttnnnn1111>>>>, spinning begins. After the time specified in XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy elapses, the SpinBox position changes automatically until the arrow button is released. The XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy resource specifies the delay in milliseconds between each automatic change. If XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy is set to 0 (zero), automatic spinning is turned off and XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyyis ignored. XXXXmmmmNNNNssssppppaaaacccciiiinnnngggg Specifies the horizontal and vertical spacing between items contained within the SpinBox widget. XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk This is called _n+1 times for _n SpinBox position changes (see the Constraint resource XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn). Reasons sent by the callback are XXXXmmmmCCCCRRRR____OOOOKKKK, XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____NNNNEEEEXXXXTTTT, XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____PPPPRRRRIIIIOOOORRRR, XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____FFFFIIIIRRRRSSSSTTTT, or XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____LLLLAAAASSSSTTTT. Other members are detailed in the callback structure description. XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNarrowSensitivity XmCArrowSensitivity unsigned char XmARROWS_DEFAULT_SENSITIVITY CSG XmNdecimalPoints XmCDecimalPoints short 0 CSG XmNincrementValue XmCIncrementValue int 1 CSG XmNmaximumValue XmCMaximumValue int 10 CSG XmNminimumValue XmCMinimumValue int 0 CSG XmNnumValues XmCNumValues int 0 CSG XmNposition XmCPosition int 0 CSG XmNpositionType XmCPositionType char XmPOSITION_VALUE CG XmNspinBoxChildType XmSpinBoxChildType unsigned char XmSTRING CG XmNvalues XmCValues XmStringTable NULL CSG XXXXmmmmNNNNaaaarrrrrrrroooowwwwSSSSeeeennnnssssiiiittttiiiivvvviiiittttyyyy Specifies the sensitivity of the arrows for a SpinBox child. By using this resource in the definition of a SpinBox child, the application programmer can override the default SpinBox Page 6 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) sensitivity (set by XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAArrrrrrrroooowwwwSSSSeeeennnnssssiiiittttiiiivvvviiiittttyyyy) for a particular child. This allows each traversable child to have a different arrow sensitivity. The arrow sensitivity values are as follows: XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____SSSSEEEENNNNSSSSIIIITTTTIIIIVVVVEEEE Both arrows are sensitive. XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____DDDDEEEECCCCRRRREEEEMMMMEEEENNNNTTTT____SSSSEEEENNNNSSSSIIIITTTTIIIIVVVVEEEE Only the decrement arrow (as determined by XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn) is sensitive. XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____IIIINNNNCCCCRRRREEEEMMMMEEEENNNNTTTT____SSSSEEEENNNNSSSSIIIITTTTIIIIVVVVEEEE Only the increment arrow (as determined by XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn) is sensitive. XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____IIIINNNNSSSSEEEENNNNSSSSIIIITTTTIIIIVVVVEEEE Both arrows are insensitive. XXXXmmmmAAAARRRRRRRROOOOWWWWSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT____SSSSEEEENNNNSSSSIIIITTTTIIIIVVVVIIIITTTTYYYY Use the sensitivity specified in the XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttAAAArrrrrrrroooowwwwSSSSeeeennnnssssiiiittttiiiivvvviiiittttyyyy resource. XXXXmmmmNNNNddddeeeecccciiiimmmmaaaallllPPPPooooiiiinnnnttttssss Specifies the number of decimal places used when displaying the value of a SpinBox numeric type child. If the number of decimal places specified is greater than the number of digits in a displayed value, the value is padded with 0 (zeros). For example, when _X_m_N_i_n_i_t_i_a_l_V_a_l_u_e is 1 and XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmmVVVVaaaalllluuuueeee is 1000 and XXXXmmmmNNNNddddeeeecccciiiimmmmaaaallllPPPPooooiiiinnnnttttssss is 3, the range of values displayed in the SpinBox is 0.001 to 1.000. This is used only when XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee is XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC. XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttVVVVaaaalllluuuueeee Specifies the amount by which to increment or decrement a SpinBox numeric type child. This is used only when XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee is XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC. XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmmVVVVaaaalllluuuueeee Specifies the highest possible value for a numeric SpinBox. This is used only when XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeeeis XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC. XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmmVVVVaaaalllluuuueeee Specifies the lowest possible value for a numeric SpinBox. This is used only when XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeeeis XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC. XXXXmmmmNNNNnnnnuuuummmmVVVVaaaalllluuuueeeessss Page 7 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) Specifies the number of strings in XXXXmmmmNNNNvvvvaaaalllluuuueeeessss. The application must change this value when strings are added or removed from XXXXmmmmNNNNvvvvaaaalllluuuueeeessss. This is used only when XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeeeis XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG. XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn Specifies the position of the currently displayed item. The interpritation of _X_m_N_p_o_s_i_t_i_o_n is dependent upon the value of the _X_m_N_p_o_s_i_t_i_o_n_T_y_p_e resource. When _X_m_N_p_o_s_i_t_i_o_n_T_y_p_e is _X_m_P_O_S_I_T_I_O_N__I_N_D_E_X the _X_m_N_p_o_s_i_t_i_o_n value is interpreted as follows: For _X_m_S_p_i_n_B_o_x children of type _X_m_N_U_M_E_R_I_C, the _X_m_N_p_o_s_i_t_i_o_n resource is interpreted as an index into an array of items. The minimum allowable value for _X_m_N_p_o_s_i_t_i_o_n is 0. The maximum allowable value for _X_m_N_p_o_s_i_t_i_o_nis ((((XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmmVVVVaaaalllluuuueeee---- XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmmVVVVaaaalllluuuueeee))))////XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttVVVVaaaalllluuuueeee. The value display by the _X_m_S_p_i_n_B_o_x child is XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmmVVVVaaaalllluuuueeee++++((((XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn****XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttVVVVaaaalllluuuueeee)))). For _X_m_S_p_i_n_B_o_x children of type _X_m_S_T_R_I_N_G, the _X_m_N_p_o_s_i_t_i_o_n resource is interpreted as an index into an array of _X_m_N_n_u_m_V_a_l_u_e_s items. The minimum allowable value for _X_m_N_p_o_s_i_t_i_o_n is 0. The maximum allowable value for _X_m_N_p_o_s_i_t_i_o_nis XXXXmmmmNNNNnnnnuuuummmmVVVVaaaalllluuuueeeessss ---- 1111. The value displayed by the _X_m_S_p_i_n_B_o_x is the _X_m_N_p_o_s_i_t_i_o_n'th value in the _X_m_N_v_a_l_u_e_s array. When _X_m_N_p_o_s_i_t_i_o_n_T_y_p_e is _X_m_P_O_S_I_T_I_O_N__V_A_L_U_E the _X_m_N_p_o_s_i_t_i_o_n value is interpreted as follows: For _X_m_S_p_i_n_B_o_x children of type _X_m_N_U_M_E_R_I_C, the _X_m_N_p_o_s_i_t_i_o_n resource is interpreted as the actual value to be displayed. The minimum allowable value for _X_m_N_p_o_s_i_t_i_o_n is _X_m_N_m_i_n_i_m_u_m_V_a_l_u_e. The maximum allowable value for _X_m_N_p_o_s_i_t_i_o_n is _X_m_N_m_a_x_i_m_u_m_V_a_l_u_e. The value displayed by the _X_m_S_p_i_n_B_o_x child is _X_m_N_p_o_s_i_t_i_o_n. For _X_m_S_p_i_n_B_o_x children of type _X_m_S_T_R_I_N_G, the interpretation is the same for _X_m_P_O_S_I_T_I_O_N__V_A_L_U_E as for _X_m_P_O_S_I_T_I_O_N__I_N_D_E_X. Position values falling outside the specified range are invalid. When an application assigns a value to _X_m_N_p_o_s_i_t_i_o_n which is less than the minimum, _X_m_N_p_o_s_i_t_i_o_n is set to the minimum and an error message is displayed. When an application assigns a value to _X_m_N_p_o_s_i_t_i_o_n which is greater than the maximum, _X_m_N_p_o_s_i_t_i_o_n is set to the maximum and an error message is displayed. Page 8 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnTTTTyyyyppppeeee Specifies how values the _X_m_N_p_o_s_i_t_i_o_n resource are to be interpreted. Valid values include _X_m_P_O_S_I_T_I_O_N__I_N_D_E_Xand _X_m_P_O_S_I_T_I_O_N__V_A_L_U_E. XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee Specifies the type of data displayed in the child: XXXXmmmmNNNNUUUUMMMMEEEERRRRIIIICCCC The SpinBox choice range is defined by numeric minimum, maximum, and incremental values. XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG The SpinBox choices are alphanumeric. XXXXmmmmNNNNvvvvaaaalllluuuueeeessss Specifies the array of XXXXmmmmSSSSttttrrrriiiinnnnggggs to be displayed in a SpinBox string type child. The application must change XXXXmmmmNNNNnnnnuuuummmmVVVVaaaalllluuuueeeessss when strings are added to or removed from XXXXmmmmNNNNvvvvaaaalllluuuueeeessss. This is used only when XXXXmmmmNNNNssssppppiiiinnnnBBBBooooxxxxCCCChhhhiiiillllddddTTTTyyyyppppeeee is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss SpinBox inherits behavior and resources from the superclasses described in the following tables. For a complete description of each resource, refer to the reference page for that superclass. XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNbottomShadowColor XmCBottomShadowColor Pixel dynamic CSG XmNbottomShadowPixmap XmCBottomShadowPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNforeground XmCForeground Pixel dynamic CSG XmNhelpCallback XmCCallback XtCallbackList NULL C XmNhighlightColor XmCHighlightColor Pixel dynamic CSG XmNhighlightPixmap XmCHighlightPixmap Pixmap dynamic CSG XmNinitialFocus XmCInitialFocus Widget dynamic CSG XmNlayoutDirection XmCLayoutDirection XmDirection dynamic CG XmNnavigationType XmCNavigationType XmNavigationType XmTAB_GROUP CSG XmNpopupHandlerCallback XmCCallback XtCallbackList NULL C XmNshadowThickness XmCShadowThickness Dimension 0 CSG XmNstringDirection XmCStringDirection XmStringDirection dynamic CG XmNtopShadowColor XmCTopShadowColor Pixel dynamic CSG XmNtopShadowPixmap XmCTopShadowPixmap Pixmap dynamic CSG XmNtraversalOn XmCTraversalOn Boolean True CSG XmNunitType XmCUnitType unsigned char dynamic CSG XmNuserData XmCUserData XtPointer NULL CSG CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNchildren XmCReadOnly WidgetList NULL G XmNinsertPosition XmCInsertPosition XtOrderProc NULL CSG Page 9 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) XmNnumChildren XmCReadOnly Cardinal 0 G CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNaccelerators XmCAccelerators XtAccelerators dynamic CSG XmNancestorSensitive XmCSensitive Boolean dynamic G XmNbackground XmCBackground Pixel dynamic CSG XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderWidth XmCBorderWidth Dimension 0 CSG XmNcolormap XmCColormap Colormap dynamic CG XmNdepth XmCDepth int dynamic CG XmNdestroyCallback XmCCallback XtCallbackList NULL C XmNheight XmCHeight Dimension dynamic CSG XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG XmNscreen XmCScreen Screen * dynamic CG XmNsensitive XmCSensitive Boolean True CSG XmNtranslations XmCTranslations XtTranslations dynamic CSG XmNwidth XmCWidth Dimension dynamic CSG XmNx XmCPosition Position 0 CSG XmNy XmCPosition Position 0 CSG CCCCaaaallllllllbbbbaaaacccckkkk A pointer to the following structure is passed to each callback: typedef struct { int _r_e_a_s_o_n; XEvent * _e_v_e_n_t; Widget _w_i_d_g_e_t; Boolean _d_o_i_t; int _p_o_s_i_t_i_o_n; XmString _v_a_l_u_e; Boolean _c_r_o_s_s_e_d__b_o_u_n_d_a_r_y; } XmSpinBoxCallbackStruct; _r_e_a_s_o_n Indicates why the callback was invoked. Reasons may be the following: XXXXmmmmCCCCRRRR____OOOOKKKK Spinning has stopped because the SpinBox arrow has been disarmed. XXXXmmmmCCCCRRRR____OOOOKKKK is either the last or only call. XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____NNNNEEEEXXXXTTTT The increment arrow has been armed and position is increasing. Further callbacks will come. For a numeric type child, the values displayed are approaching the maximum. For a string SpinBox, the values displayed are Page 10 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) approaching the last entry in the array of XXXXmmmmSSSSttttrrrriiiinnnngggg s. XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____PPPPRRRRIIIIOOOORRRR The decrement arrow has been armed and position is decreasing. Further callbacks will come. For a numeric type child, the values displayed are approaching the minimum. For a string type child, the values displayed are approaching the first entry in the array of XXXXmmmmSSSSttttrrrriiiinnnnggggs. XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____FFFFIIIIRRRRSSSSTTTT The begin data (<<<<oooossssffffBBBBeeeeggggiiiinnnnDDDDaaaattttaaaa>>>>) key sequence has been pressed. The SpinBox is at its first position, displaying the lowest value or the first entry in the array of XXXXmmmmSSSSttttrrrriiiinnnnggggs. XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____LLLLAAAASSSSTTTT The end data (<<<<oooossssffffEEEEnnnnddddDDDDaaaattttaaaa>>>>) key sequence has been pressed. The SpinBox is at its last position, displaying the highest value or the last entry in the array of XXXXmmmmSSSSttttrrrriiiinnnnggggs. _e_v_e_n_t Points to the _X_E_v_e_n_t that triggered this callback. _w_i_d_g_e_t Specifies the child widget affected by this callback. _d_o_i_t When the callback is XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, _d_o_i_t indicates whether or not an action will be performed before the SpinBox position changes. If the callback leaves _d_o_i_t set to True (the default), the spinning action is performed. If the callback sets _d_o_i_t to False, the spinning action is not performed. When the callback is XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk, _d_o_i_t is ignored. _p_o_s_i_t_i_o_n Specifies the next value of the SpinBox position (same as XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn). This is an output field for the XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, which may change the next position as dictated by the needs of an application. _v_a_l_u_e Specifies the new XXXXmmmmSSSSttttrrrriiiinnnngggg value in the text child widget. The user program must copy this string if it is to be used outside the callback routine. _c_r_o_s_s_e_d__b_o_u_n_d_a_r_y Page 11 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) Specifies whether or not the SpinBox has crossed the upper or lower boundary (the last or first compound string, or the maximum or minimum value). The _c_r_o_s_s_e_d__b_o_u_n_d_a_r_y value is True if the SpinBox has just crossed a boundary, and False if it has not. TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss The XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx translations are as follows: The following key names are listed in the X standard key event translation table syntax. This format is the one used by Motif to specify the widget actions corresponding to a given key. A brief overview of the format is provided under VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3). For a complete description of the format, please refer to the X Toolkit Instrinsics Documentation. <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>: SpinBArm() <<<<BBBBttttnnnn1111UUUUpppp>>>>: SpinBDisarm() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>> : SpinBPrior() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>> : SpinBNext() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>> : SpinBLeft() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>> : SpinBRight() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnDDDDaaaattttaaaa>>>> : SpinBFirst() ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddDDDDaaaattttaaaa>>>> : SpinBLast() AAAAcccccccceeeelllleeeerrrraaaattttoooorrrrssss The XXXXmmmmNNNNaaaacccccccceeeelllleeeerrrraaaattttoooorrrrssss resource of a SpinBox are added to each traversable text child. The default XXXXmmmmNNNNaaaacccccccceeeelllleeeerrrraaaattttoooorrrrssss are defined in the following list. The bindings for <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>> and <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>> cannot be changed. <<<<KKKKeeeeyyyy>>>> <<<<oooossssffffUUUUpppp>>>>: SpinBPrior() <<<<KKKKeeeeyyyy>>>> <<<<oooossssffffDDDDoooowwwwnnnn>>>>: SpinBNext() Page 12 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) <<<<KKKKeeeeyyyyUUUUpppp>>>> <<<<oooossssffffUUUUpppp>>>>: SpinBDisarm() <<<<KKKKeeeeyyyyUUUUpppp>>>> <<<<oooossssffffDDDDoooowwwwnnnn>>>>: SpinBDisarm() <<<<KKKKeeeeyyyy>>>> <<<<oooossssffffLLLLeeeefffftttt>>>>: SpinBLeft() <<<<KKKKeeeeyyyy>>>> <<<<oooossssffffRRRRiiiigggghhhhtttt>>>>: SpinBRight() <<<<KKKKeeeeyyyyUUUUpppp>>>> <<<<oooossssffffLLLLeeeefffftttt>>>>: SpinBDisarm() <<<<KKKKeeeeyyyyUUUUpppp>>>> <<<<oooossssffffRRRRiiiigggghhhhtttt>>>>: SpinBDisarm() <<<<KKKKeeeeyyyy>>>> <<<<oooossssffffBBBBeeeeggggiiiinnnnDDDDaaaattttaaaa>>>>: SpinBFirst() <<<<KKKKeeeeyyyy>>>> <<<<oooossssffffEEEEnnnnddddDDDDaaaattttaaaa>>>>: SpinBLast() AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss The XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx action routines are as follows: SpinBArm(): Visually arms the SpinBox by drawing the armed arrow so that it appears to be depressed. This action is initiated when the user presses <<<<BBBBttttnnnn1111>>>> while the pointer is within the boundaries of either the increment or decrement arrow. The arrow remains visually armed as long as <<<<BBBBttttnnnn1111>>>> remains depressed. If the time period specified by XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy is not greater than zero milliseconds, nothing else happens while <<<<BBBBttttnnnn1111>>>> remains depressed. If the time period specified by XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy is greater than zero milliseconds, and the arrow is disarmed before the time period specified by XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy has elapsed, nothing else happens in this action. If the time period specified by XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy is greater than zero milliseconds, and the arrow is still armed after the time period specified by XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy has elapsed, the following occurs: +o The _r_e_a_s_o_n member of the SpinBox callback Page 13 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) structure, XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt, is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____NNNNEEEEXXXXTTTTif the increment arrow is armed, or to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____PPPPRRRRIIIIOOOORRRR if the decrement arrow is armed. +o The _p_o_s_i_t_i_o_n member is set to the next position. +o The _d_o_i_t member is set to True. +o XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is invoked. The application may change the value of _p_o_s_i_t_i_o_n and _d_o_i_t. If the application sets _d_o_i_t to False, nothing else happens until the XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy period has elapsed, or until <<<<BBBBttttnnnn1111>>>> is released. If _d_o_i_t remains set to True, the following occurs: +o The value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnis changed to the value of _p_o_s_i_t_i_o_n in the SpinBox callback structure. +o The text corresponding to the new position is displayed in the traversable text child that currently has focus. +o The _r_e_a_s_o_n member of the SpinBox callback structure is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____NNNNEEEEXXXXTTTT if the increment arrow is armed, or XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____PPPPRRRRIIIIOOOORRRR if the decrement arrow is armed. +o The _p_o_s_i_t_i_o_n member is set to the current (new) value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn. +o XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is called. SpinBox ignores any changes to _p_o_s_i_t_i_o_n or _d_o_i_t members made by XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk. These events are repeated each time the XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy period elapses and the arrow remains armed. SpinBDisarm(): Visually disarms the SpinBox by drawing the previously armed arrow so that it no longer appears to be depressed. If the time period specified by XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy is not greater than zero milliseconds, or the time period specified by XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy has not Page 14 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) elapsed, the following then occurs: +o The _r_e_a_s_o_n member of the SpinBox callback structure, XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt, is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____NNNNEEEEXXXXTTTTif the increment arrow is armed, or to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____PPPPRRRRIIIIOOOORRRR if the decrement arrow is armed. +o The _p_o_s_i_t_i_o_n member is set to the next position. +o The _d_o_i_t member is set to True. +o The XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, if there is one, is invoked. The application may change the value of _p_o_s_i_t_i_o_n and _d_o_i_t. If the application sets _d_o_i_t to False, nothing else happens until the XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyyperiod has elapsed, or until <<<<BBBBttttnnnn1111>>>> is released. If _d_o_i_t remains set to True, the following occurs: +o The value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnis changed to the value of _p_o_s_i_t_i_o_n in the SpinBox callback structure. +o The text corresponding to the new position is displayed in the traversable text child that currently has focus. +o The _r_e_a_s_o_n member of the SpinBox callback structure is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____NNNNEEEEXXXXTTTT if the increment arrow is armed, or XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____PPPPRRRRIIIIOOOORRRR if the decrement arrow is armed. +o The _p_o_s_i_t_i_o_n member is set to the current (new) value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn. +o XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is called. SpinBox ignores any changes to _p_o_s_i_t_i_o_n or _d_o_i_t members made by an XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk. If an XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkprocedure is issued after the button has been armed, regardless of the value of XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy or whether the XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy has expired: +o The _r_e_a_s_o_n member of the SpinBox callback structure is set to XXXXmmmmCCCCRRRR____OOOOKKKK. +o The _p_o_s_i_t_i_o_n member is set to the current Page 15 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn. +o XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is called. SpinBFirst(): The following occurs: +o The _r_e_a_s_o_n member of the SpinBox callback structure, XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt, is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____FFFFIIIIRRRRSSSSTTTT. +o The _p_o_s_i_t_i_o_n member is set to the first (0) position. +o The _d_o_i_t member is set to True. +o XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is invoked. The application may change the value of _p_o_s_i_t_i_o_n and _d_o_i_t. If the application sets _d_o_i_t to False, nothing else happens until the XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyyperiod has elapsed, or until <<<<BBBBttttnnnn1111>>>> is released. If _d_o_i_t remains set to True, the following occurs: +o The value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnis changed to the value of _p_o_s_i_t_i_o_n in the SpinBox callback structure. +o The text corresponding to the new position is displayed in the traversable text child that currently has focus. +o The _r_e_a_s_o_n member of the SpinBox callback structure is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____FFFFIIIIRRRRSSSSTTTT. +o The _p_o_s_i_t_i_o_n member is set to the current (new) value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn. +o XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is called. +o The _r_e_a_s_o_n member of the SpinBox callback structure is set to XXXXmmmmCCCCRRRR____OOOOKKKK. +o The _p_o_s_i_t_i_o_n member is set to the current (new) XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnvalue. +o The XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkis called again. SpinBox ignores any changes to _p_o_s_i_t_i_o_n or _d_o_i_t members made by Page 16 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk. SpinBLast(): The following occurs: +o The _r_e_a_s_o_n member of the SpinBox callback structure, XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt, is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____LLLLAAAASSSSTTTT. +o The _p_o_s_i_t_i_o_n member is set to the last position. +o The _d_o_i_t member is set to True. +o XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is invoked. The application may change the value of _p_o_s_i_t_i_o_n and _d_o_i_t. If the application sets _d_o_i_t to False, nothing else happens until the XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyyperiod has elapsed, or until <<<<BBBBttttnnnn1111>>>> is released. If _d_o_i_t remains set to True, the following occurs: +o The value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnis changed to the value of _p_o_s_i_t_i_o_n in the SpinBox callback structure. +o The text corresponding to the new position is displayed in the traversable text child that currently has focus. +o The _r_e_a_s_o_n member of the SpinBox callback structure is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____LLLLAAAASSSSTTTT. +o The _p_o_s_i_t_i_o_n member is set to the current (new) value XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn. +o XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is called. +o The _r_e_a_s_o_n member of the SpinBox callback structure is set to XXXXmmmmCCCCRRRR____OOOOKKKK. +o The _p_o_s_i_t_i_o_n member is set to the current (new) of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn. +o XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkis called again. SpinBox ignores any changes to the _p_o_s_i_t_i_o_n or _d_o_i_t members made by XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk. SpinBLeft(): Page 17 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) If the VendorShell resource XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn is left-to-right, the SSSSppppiiiinnnnBBBBPPPPrrrriiiioooorrrr action is invoked. Otherwise, the SSSSppppiiiinnnnBBBBNNNNeeeexxxxtttt action is invoked. SpinBNext(): Visually arms the SpinBox by drawing the increment arrow so that it appears to be depressed. The following occurs: +o The _r_e_a_s_o_n member of the SpinBox callback structure, XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt, is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____NNNNEEEEXXXXTTTT. +o The _p_o_s_i_t_i_o_n member is set to the next position. +o The _d_o_i_t member is set to True. +o XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is invoked. The application may change the value of _p_o_s_i_t_i_o_n and _d_o_i_t. If the application sets _d_o_i_t to False, nothing else happens until the XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyyperiod has elapsed, or until <<<<BBBBttttnnnn1111>>>> is released. If _d_o_i_t remains set to True, the following occurs: +o The value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnis changed to the value of _p_o_s_i_t_i_o_n in the SpinBox callback structure. +o The text corresponding to the new position is displayed in the traversable text child that currently has focus. +o The _r_e_a_s_o_n member of the SpinBox callback structure is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____NNNNEEEEXXXXTTTT. +o The _p_o_s_i_t_i_o_n member is set to the current (new) value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn. +o XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is called. +o The _r_e_a_s_o_n member of the SpinBox callback structure is set to XXXXmmmmCCCCRRRR____OOOOKKKK. +o The _p_o_s_i_t_i_o_n member is set to the current (new) XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn. +o The XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkis called again. SpinBox ignores any changes to _p_o_s_i_t_i_o_n or Page 18 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) _d_o_i_t members made by XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk. SpinBPrior(): Visually arms the SpinBox by drawing the decrement arrow so that it appears to be depressed. The following occurs: +o The _r_e_a_s_o_n member of the SpinBox callback structure, XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxxCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt, is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____PPPPRRRRIIIIOOOORRRR. +o The _p_o_s_i_t_i_o_n member is set to the next position. +o The _d_o_i_t member is set to True. +o XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is invoked. The application may change the value of _p_o_s_i_t_i_o_n and _d_o_i_t. If the application sets _d_o_i_t to False, nothing else happens until the XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyyperiod has elapsed, or until <<<<BBBBttttnnnn1111>>>> is released. If _d_o_i_t remains set to True, the following occurs: +o The value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnnis changed to the value of _p_o_s_i_t_i_o_n in the SpinBox callback structure. +o The text corresponding to the new position is displayed in the traversable text child that currently has focus. +o The _r_e_a_s_o_n member of the SpinBox callback structure is set to XXXXmmmmCCCCRRRR____SSSSPPPPIIIINNNN____PPPPRRRRIIIIOOOORRRR. +o The _p_o_s_i_t_i_o_n member is set to the current (new) value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn. +o XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk, if it exists, is called. +o The _r_e_a_s_o_n member of the SpinBox callback structure is set to XXXXmmmmCCCCRRRR____OOOOKKKK. +o The _p_o_s_i_t_i_o_n member is set to the current (new) value of XXXXmmmmNNNNppppoooossssiiiittttiiiioooonnnn. +o XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkis called again. SpinBox ignores any changes to _p_o_s_i_t_i_o_n or _d_o_i_t members made by Page 19 (printed 10/3/02) XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSppppiiiinnnnBBBBooooxxxx((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk. SpinBRight(): If the VendorShell resource XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn is left-to-right, the SSSSppppiiiinnnnBBBBNNNNeeeexxxxtttt action is invoked. Otherwise, the SSSSppppiiiinnnnBBBBPPPPrrrriiiioooorrrr action is invoked. RRRREEEELLLLAAAATTTTEEEEDDDD CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt(3), CCCCoooorrrreeee(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSppppiiiinnnnBBBBooooxxxx(3), XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3), and XXXXmmmmSSSSttttrrrriiiinnnngggg(3). Page 20 (printed 10/3/02) 
